Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More
Socket
Sign inDemoInstall
Socket

@visulima/humanizer

Package Overview
Dependencies
Maintainers
0
Versions
15
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@visulima/humanizer

Humanizer is a library for humanizing data in a human-readable form.

  • 1.0.14
  • latest
  • Source
  • npm
  • Socket score

Version published
Weekly downloads
762
increased by32.06%
Maintainers
0
Weekly downloads
 
Created
Source

Visulima humanizer

Humanizer is a library for humanizing data in a human-readable form.


typescript-image npm-image license-image


Daniel Bannert's open source work is supported by the community on GitHub Sponsors


Install

npm install @visulima/humanizer
yarn add @visulima/humanizer
pnpm add @visulima/humanizer

Usage

Bytes

Convert bytes to human-readable strings and vice versa: 1024 → 1KB and 1KB → 1024

import { formatBytes, p } from "@visulima/humanizer";

console.log(formatBytes(123412341, { decimals: 2 })); // "117.70 MB"
console.log(parseBytes("117.70 MB")); // 123417395.2

// Localization support in both directions
console.log(formatBytes(123412341, { decimals: 2, locale: "de" })); // "117,70 MB"
console.log(parseBytes("117,70 MB", { locale: "de" })); // 123417395.2

// Use a specified unit
console.log(formatBytes(123412341, { decimals: 2, unit: "KB" })); // "120,519.86 KB"

// Use a long unit
console.log(formatBytes(123412341, { decimals: 2, unit: "GB", long: true })); // "0.11 Gigabytes"

// Use a differnet base
console.log(formatBytes(123412341, { decimals: 2, base: 10 })); // "123.41 MB"
Supported locales

Default: "en".

formatBytes and parseBytes supports the following locales:

Supported locales
  • af-NA"
  • af"
  • agq"
  • ak"
  • am"
  • ar-AE"
  • ar-BH"
  • ar-DJ"
  • ar-DZ"
  • ar-EG"
  • ar-EH"
  • ar-ER"
  • ar-IL"
  • ar-IQ"
  • ar-JO"
  • ar-KM"
  • ar-KW"
  • ar-LB"
  • ar-LY"
  • ar-MA"
  • ar-MR"
  • ar-OM"
  • ar-PS"
  • ar-QA"
  • ar-SA"
  • ar-SD"
  • ar-SO"
  • ar-SS"
  • ar-SY"
  • ar-TD"
  • ar-TN"
  • ar-YE"
  • ar"
  • as"
  • asa"
  • ast"
  • az-Cyrl"
  • az-Latn"
  • az"
  • bas"
  • be-tarask"
  • be"
  • bem"
  • bez"
  • bg"
  • bm"
  • bn-IN"
  • bn"
  • bo-IN"
  • bo"
  • br"
  • brx"
  • bs-Cyrl"
  • bs-Latn"
  • bs"
  • ca-AD"
  • ca-ES-valencia"
  • ca-FR"
  • ca-IT"
  • ca"
  • ccp-IN"
  • ccp"
  • ce"
  • ceb"
  • cgg"
  • chr"
  • ckb-IR"
  • ckb"
  • cs"
  • cy"
  • da-GL"
  • da"
  • dav"
  • de-AT"
  • de-BE"
  • de-CH"
  • de-IT"
  • de-LI"
  • de-LU"
  • de"
  • dje"
  • doi"
  • dsb"
  • dua"
  • dyo"
  • dz"
  • ebu"
  • ee-TG"
  • ee"
  • el-CY"
  • el"
  • en-001"
  • en-150"
  • en-AE"
  • en-AG"
  • en-AI"
  • en-AS"
  • en-AT"
  • en-AU"
  • en-BB"
  • en-BE"
  • en-BI"
  • en-BM"
  • en-BS"
  • en-BW"
  • en-BZ"
  • en-CA"
  • en-CC"
  • en-CH"
  • en-CK"
  • en-CM"
  • en-CX"
  • en-CY"
  • en-DE"
  • en-DG"
  • en-DK"
  • en-DM"
  • en-ER"
  • en-FI"
  • en-FJ"
  • en-FK"
  • en-FM"
  • en-GB"
  • en-GD"
  • en-GG"
  • en-GH"
  • en-GI"
  • en-GM"
  • en-GU"
  • en-GY"
  • en-HK"
  • en-IE"
  • en-IL"
  • en-IM"
  • en-IN"
  • en-IO"
  • en-JE"
  • en-JM"
  • en-KE"
  • en-KI"
  • en-KN"
  • en-KY"
  • en-LC"
  • en-LR"
  • en-LS"
  • en-MG"
  • en-MH"
  • en-MO"
  • en-MP"
  • en-MS"
  • en-MT"
  • en-MU"
  • en-MW"
  • en-MY"
  • en-NA"
  • en-NF"
  • en-NG"
  • en-NL"
  • en-NR"
  • en-NU"
  • en-NZ"
  • en-PG"
  • en-PH"
  • en-PK"
  • en-PN"
  • en-PR"
  • en-PW"
  • en-RW"
  • en-SB"
  • en-SC"
  • en-SD"
  • en-SE"
  • en-SG"
  • en-SH"
  • en-SI"
  • en-SL"
  • en-SS"
  • en-SX"
  • en-SZ"
  • en-TC"
  • en-TK"
  • en-TO"
  • en-TT"
  • en-TV"
  • en-TZ"
  • en-UG"
  • en-UM"
  • en-VC"
  • en-VG"
  • en-VI"
  • en-VU"
  • en-WS"
  • en-ZA"
  • en-ZM"
  • en-ZW"
  • en"
  • eo"
  • es-419"
  • es-AR"
  • es-BO"
  • es-BR"
  • es-BZ"
  • es-CL"
  • es-CO"
  • es-CR"
  • es-CU"
  • es-DO"
  • es-EA"
  • es-EC"
  • es-GQ"
  • es-GT"
  • es-HN"
  • es-IC"
  • es-MX"
  • es-NI"
  • es-PA"
  • es-PE"
  • es-PH"
  • es-PR"
  • es-PY"
  • es-SV"
  • es-US"
  • es-UY"
  • es-VE"
  • es"
  • et"
  • eu"
  • ewo"
  • fa-AF"
  • fa"
  • ff-Adlm-BF"
  • ff-Adlm-CM"
  • ff-Adlm-GH"
  • ff-Adlm-GM"
  • ff-Adlm-GW"
  • ff-Adlm-LR"
  • ff-Adlm-MR"
  • ff-Adlm-NE"
  • ff-Adlm-NG"
  • ff-Adlm-SL"
  • ff-Adlm-SN"
  • ff-Adlm"
  • ff-Latn-BF"
  • ff-Latn-CM"
  • ff-Latn-GH"
  • ff-Latn-GM"
  • ff-Latn-GN"
  • ff-Latn-GW"
  • ff-Latn-LR"
  • ff-Latn-MR"
  • ff-Latn-NE"
  • ff-Latn-NG"
  • ff-Latn-SL"
  • ff-Latn"
  • ff"
  • fi"
  • fil"
  • fo-DK"
  • fo"
  • fr-BE"
  • fr-BF"
  • fr-BI"
  • fr-BJ"
  • fr-BL"
  • fr-CA"
  • fr-CD"
  • fr-CF"
  • fr-CG"
  • fr-CH"
  • fr-CI"
  • fr-CM"
  • fr-DJ"
  • fr-DZ"
  • fr-GA"
  • fr-GF"
  • fr-GN"
  • fr-GP"
  • fr-GQ"
  • fr-HT"
  • fr-KM"
  • fr-LU"
  • fr-MA"
  • fr-MC"
  • fr-MF"
  • fr-MG"
  • fr-ML"
  • fr-MQ"
  • fr-MR"
  • fr-MU"
  • fr-NC"
  • fr-NE"
  • fr-PF"
  • fr-PM"
  • fr-RE"
  • fr-RW"
  • fr-SC"
  • fr-SN"
  • fr-SY"
  • fr-TD"
  • fr-TG"
  • fr-TN"
  • fr-VU"
  • fr-WF"
  • fr-YT"
  • fr"
  • fur"
  • fy"
  • ga-GB"
  • ga"
  • gd"
  • gl"
  • gsw-FR"
  • gsw-LI"
  • gsw"
  • gu"
  • guz"
  • gv"
  • ha-GH"
  • ha-NE"
  • ha"
  • haw"
  • he"
  • hi"
  • hr-BA"
  • hr"
  • hsb"
  • hu"
  • hy"
  • ia"
  • id"
  • ig"
  • ii"
  • is"
  • it-CH"
  • it-SM"
  • it-VA"
  • it"
  • ja"
  • jgo"
  • jmc"
  • jv"
  • ka"
  • kab"
  • kam"
  • kde"
  • kea"
  • kgp"
  • khq"
  • ki"
  • kk"
  • kkj"
  • kl"
  • kln"
  • km"
  • kn"
  • ko-KP"
  • ko"
  • kok"
  • ks-Arab"
  • ks"
  • ksb"
  • ksf"
  • ksh"
  • ku"
  • kw"
  • ky"
  • lag"
  • lb"
  • lg"
  • lkt"
  • ln-AO"
  • ln-CF"
  • ln-CG"
  • ln"
  • lo"
  • lrc-IQ"
  • lrc"
  • lt"
  • lu"
  • luo"
  • luy"
  • lv"
  • mai"
  • mas-TZ"
  • mas"
  • mer"
  • mfe"
  • mg"
  • mgh"
  • mgo"
  • mi"
  • mk"
  • ml"
  • mn"
  • mni-Beng"
  • mni"
  • mr"
  • ms-BN"
  • ms-ID"
  • ms-SG"
  • ms"
  • mt"
  • mua"
  • my"
  • mzn"
  • naq"
  • nb-SJ"
  • nb"
  • nd"
  • nds-NL"
  • nds"
  • ne-IN"
  • ne"
  • nl-AW"
  • nl-BE"
  • nl-BQ"
  • nl-CW"
  • nl-SR"
  • nl-SX"
  • nl"
  • nmg"
  • nn"
  • nnh"
  • no"
  • nus"
  • nyn"
  • om-KE"
  • om"
  • or"
  • os-RU"
  • os"
  • pa-Arab"
  • pa-Guru"
  • pa"
  • pcm"
  • pl"
  • ps-PK"
  • ps"
  • pt-AO"
  • pt-CH"
  • pt-CV"
  • pt-GQ"
  • pt-GW"
  • pt-LU"
  • pt-MO"
  • pt-MZ"
  • pt-PT"
  • pt-ST"
  • pt-TL"
  • pt"
  • qu-BO"
  • qu-EC"
  • qu"
  • rm"
  • rn"
  • ro-MD"
  • ro"
  • rof"
  • ru-BY"
  • ru-KG"
  • ru-KZ"
  • ru-MD"
  • ru-UA"
  • ru"
  • rw"
  • rwk"
  • sa"
  • sah"
  • saq"
  • sat-Olck"
  • sat"
  • sbp"
  • sc"
  • sd-Arab"
  • sd-Deva"
  • sd"
  • se-FI"
  • se-SE"
  • se"
  • seh"
  • ses"
  • sg"
  • shi-Latn"
  • shi-Tfng"
  • shi"
  • si"
  • sk"
  • sl"
  • smn"
  • sn"
  • so-DJ"
  • so-ET"
  • so-KE"
  • so"
  • sq-MK"
  • sq-XK"
  • sq"
  • sr-Cyrl-BA"
  • sr-Cyrl-ME"
  • sr-Cyrl-XK"
  • sr-Cyrl"
  • sr-Latn-BA"
  • sr-Latn-ME"
  • sr-Latn-XK"
  • sr-Latn"
  • sr"
  • su-Latn"
  • su"
  • sv-AX"
  • sv-FI"
  • sv"
  • sw-CD"
  • sw-KE"
  • sw-UG"
  • sw"
  • ta-LK"
  • ta-MY"
  • ta-SG"
  • ta"
  • te"
  • teo-KE"
  • teo"
  • tg"
  • th"
  • ti-ER"
  • ti"
  • tk"
  • to"
  • tr-CY"
  • tr"
  • tt"
  • twq"
  • tzm"
  • ug"
  • uk"
  • und"
  • ur-IN"
  • ur"
  • uz-Arab"
  • uz-Cyrl"
  • uz-Latn"
  • uz"
  • vai-Latn"
  • vai-Vaii"
  • vai"
  • vi"
  • vun"
  • wae"
  • wo"
  • xh"
  • xog"
  • yav"
  • yi"
  • yo-BJ"
  • yo"
  • yrl-CO"
  • yrl-VE"
  • yrl"
  • yue-Hans"
  • yue-Hant"
  • yue"
  • zgh"
  • zh-Hans-HK"
  • zh-Hans-MO"
  • zh-Hans-SG"
  • zh-Hans"
  • zh-Hant-HK"
  • zh-Hant-MO"
  • zh-Hant"
  • zh"
  • zu"

Duration

duration use a modified version of HumanizeDuration.

I have the time in milliseconds and I want it to become "30 minutes" or "3 days, 1 hour".

import { duration } from "@visulima/humanizer";

duration(3000);
// => "3 seconds"

duration(2250);
// => "2.25 seconds"

duration(97320000);
// => "1 day, 3 hours, 2 minutes"
Options

You can change the settings by passing options as the second argument.

units

Array of possible units to use. Units are y, mo, w, d, h, m, s, and ms.

Units are skipped if their count is zero. For example, if you pass a duration of 1000 and units ["h", "m", "s"], the output will be "1 second".

Must be in descending order of unit size. For example, ["h", "m"] is valid but ["m", "h"] is not.

Default: ["y", "mo", "w", "d", "h", "m", "s"]

duration(69000, { units: ["h", "m", "s", "ms"] });
// => "1 minute, 9 seconds"

duration(3600000, { units: ["h"] });
// => "1 hour"

duration(3600000, { units: ["m"] });
// => "60 minutes"

duration(3600000, { units: ["d", "h"] });
// => "1 hour"
largest

Integer representing the maximum number of units to use.

Default: Infinity

duration(1000000000000);
// => "31 years, 8 months, 1 week, 19 hours, 46 minutes, 40 seconds"

duration(1000000000000, { largest: 2 });
// => "31 years, 8 months"
round

A boolean that, if true, rounds the smallest unit.

Default: false

duration(1200);
// => "1.2 seconds"

duration(1200, { round: true });
// => "1 second"

duration(1600, { round: true });
// => "2 seconds"
delimiter

String to display between units.

Default: ", " in most languages, " ﻭ " for Arabic

duration(22140000);
// => "6 hours, 9 minutes"

duration(22140000, { delimiter: " and " });
// => "6 hours and 9 minutes"
spacer

String to display between the count and the word.

Default: " "

duration(260040000);
// => "3 days, 14 minutes"

duration(260040000, { spacer: " whole " });
// => "3 whole days, 14 whole minutes"
decimal

String to display between the integer and decimal parts of a count, if relevant.

Default depends on the language.

duration(1200);
// => "1.2 seconds"

duration(1200, { decimal: " point " });
// => "1 point 2 seconds"
conjunction

String to include before the final unit.

You can also set serialComma to false to eliminate the final comma.

Default: ""

duration(22140000, { conjunction: " and " });
// => "6 hours and 9 minutes"

duration(22141000, { conjunction: " and " });
// => "6 hours, 9 minutes, and 1 second"

duration(22140000, { conjunction: " and ", serialComma: false });
// => "6 hours and 9 minutes"

duration(22141000, { conjunction: " and ", serialComma: false });
// => "6 hours, 9 minutes and 1 second"
maxDecimalPoints

Integer that defines the maximum number of decimal points to show, if relevant. If undefined, the count will be converted to a string using Number.prototype.toString().

This does not round any numbers. See the round option.

Default: undefined

duration(8123.456789);
// => "8.123456789 seconds"

duration(8123.456789, { maxDecimalPoints: 3 });
// => "8.123 seconds"

duration(8100, { maxDecimalPoints: 99 });
// => "8.1 seconds"

duration(8000, { maxDecimalPoints: 99 });
// => "8 seconds"

duration(7999, { maxDecimalPoints: 2 });
// => "7.99 seconds"
digitReplacements

Array of ten strings to which will replace the numerals 0-9. Useful if a language uses different numerals.

Default: undefined for most languages, ["۰", "١", "٢", "٣", "٤", "٥", "٦", "٧", "٨", "٩"] for Arabic

duration(1234);
// => "1.234 seconds"

duration(1234, {
    digitReplacements: ["Zero", "One", "Two", "Three", "Four", "Five", "Six", "Seven", "Eight", "Nine"],
});
// => "One.TwoThreeFour seconds"
unitMeasures

Use this option with care. It is an advanced feature.

Object used to customize the value used to calculate each unit of time. Most useful when you want to update the length of years or months, which have ambiguous lengths.

Default: { y: 31557600000, mo: 2629800000, w: 604800000, d: 86400000, h: 3600000, m: 60000, s: 1000, ms: 1 }

duration(2629800000);
// => "1 month"

duration(2629800000, {
    unitMeasures: {
        y: 31557600000,
        mo: 30 * 86400000,
        w: 604800000,
        d: 86400000,
        h: 3600000,
        m: 60000,
        s: 1000,
        ms: 1,
    },
});
// => "1 month, 10 hours, 30 minutes"
language

Language for unit display. Accepts an ISO 639-1 code from one of the supported languages.

Default: "en".

import { duration } from "@visulima/humanizer";
import { durationLanguage as es } from "@visulima/humanizer/language/es";
import { durationLanguage as ko } from "@visulima/humanizer/language/ko";

duration(3000, { language: es });
// => "3 segundos"

duration(5000, { language: ko });
// => "5 초"
Supported languages

duration supports the following languages:

LanguageCode
Afrikaansaf
Albaniansq
Amharicam
Arabicar
Basqueeu
Bengalibn
Bulgarianbg
Catalanca
Central Kurdishckb
Chinese, simplifiedzh_CN
Chinese, traditionalzh_TW
Croatianhr
Czechcs
Danishda
Dutchnl
Englishen
Esperantoeo
Estonianet
Faroesefo
Farsi/Persianfa
Finnishfi
Frenchfr
Germande
Greekel
Hebrewhe
Hindihi
Hungarianhu
Icelandicis
Indonesianid
Italianit
Japaneseja
Kannadakn
Khmerkm
Koreanko
Kurdishku
Laolo
Latvianlv
Lithuanianlt
Macedonianmk
Mongolianmn
Malayms
Marathimr
Norwegianno
Polishpl
Portuguesept
Romanianro
Russianru
Serbiansr
Slovaksk
Sloveniansl
Spanishes
Swahilisw
Swedishsv
Tamilta
Telugute
Thaith
Turkishtr
Ukrainianuk
Urduur
Uzbekuz
Uzbek (Cyrillic)uz_CYR
Vietnamesevi
Welshcy

Bytes

  • pretty-bytes - Convert bytes to a human readable string: 13371.34 kB

Duration

  • HumanizeDuration - 361000 becomes "6 minutes, 1 second"
  • pretty-ms - Convert milliseconds to a human readable string: 133700000015d 11h 23m 20s

Supported Node.js Versions

Libraries in this ecosystem make the best effort to track Node.js’ release schedule. Here’s a post on why we think this is important.

Contributing

If you would like to help take a look at the list of issues and check our Contributing guidelines.

Note: please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Credits

License

The visulima humanizer is open-sourced software licensed under the MIT

Keywords

FAQs

Package last updated on 05 Oct 2024

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap
  • Changelog

Packages

npm

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc